home *** CD-ROM | disk | FTP | other *** search
/ Aminet 23 / Aminet 23 (1998)(GTI - Schatztruhe)[!][Feb 1998].iso / Aminet / comm / www / AwcrMAN.lha / AwcrMAN.doc < prev   
Text File  |  1997-10-29  |  4KB  |  118 lines
  1. Short:    Show/update AWeb cache register to 3.0
  2. Author:   Gabriele Favrin (favrin@tin.it)
  3. Requires: AWeb 1.6/2.1 or 3.0 and Kickstart 2.04 or better
  4. Version:  1.0
  5.  
  6.  
  7. LEGAL THINGS
  8.    The author is in no way responsible for moral and/or material damages that
  9.    his program may cause to people or things.  The programmer gave its best
  10.    for limiting the problems that this tool may cause, but he is not able to
  11.    guarantee the efficiency in all the situations.  Using this program, you,
  12.    the user, are responsible for all moral, material, civil and penal things.
  13.  
  14.    AwcrMAN is freeware, not public domain.  It may be spread only in
  15.    unmodified form.
  16.  
  17.  
  18. WHAT IT DOES
  19.    This program can display and/or update the AWeb cache register (the AWCR
  20.    file located in AWeb's cache directory).  AwcrMAN currently supports AWCR
  21.    used in AWeb 1.6/2.1 and 3.0.  It can display content (all or just URLs)
  22.    and convert the 1.6/2.1 format to 3.0 one to allow usage of an AWeb
  23.    1.6/2.1 cache with AWeb 3.0.
  24.  
  25.  
  26. HOW TO USE
  27.    AwcrMAN can be used only from shell (for now) and only while AWeb is NOT
  28.    running.
  29.  
  30.    Available options are:
  31.  
  32.    FILE/A,UPDATE/K,INFO/S,LIST/S,URL/S
  33.  
  34.    FILE
  35.      This is required, as it is the target of ours wishes :-)
  36.      If only the AWCR location/name is specified, program will display info
  37.      about it and count how many files are stored.
  38.  
  39.    UPDATE
  40.      If you want to update your 1.6/2.1 AWCR file you must specify this
  41.      argument followed by a destination path/file name.
  42.  
  43.      DO NOT overwrite your existing AWCR!!!
  44.  
  45.      AwcrMAN is an experimental program and result is not sure.  Also,
  46.      before using UPDATE on your AWCR you should use LIST and check if
  47.      AwcrMAN interprets correctly YOUR AWCR file.  If not then please send me
  48.      your AWCR file (I'm not interested in sites you visit, just I want to
  49.      find errors in my program).
  50.  
  51.      Obviously UPDATE works only on AWCR 1.6/2.1 files.
  52.  
  53.      After the conversion don't forget to copy the updated file to cache
  54.      directory (naming it AWCR).
  55.  
  56.    INFO
  57.      Just displays header informations about specified AWCR file.
  58.  
  59.    LIST
  60.      Displays contents of AWCR file in an human readable form.  Use it also
  61.      to check if AwcrMAN interprets correctly your AWCR file.
  62.  
  63.    URL
  64.      Displays a list of all URLs you have in cache.
  65.  
  66.  
  67. NOTE ABOUT UPDATE
  68.    The conversion process works only at AWCR file level and it is intended
  69.    for giving to users the possibility to not loose their entire cache
  70.    (sometimes very large!).
  71.  
  72.    I must quote Yvon Rozijn (AWeb author) about this:
  73.  
  74.    "There might be some more inconsistencies in the actual names of the cache
  75.     files, especially in the extensions.  But the majority of the files
  76.     should be usable after this conversion."
  77.  
  78.    So said, here AwcrMAN works well.  Good luck!
  79.  
  80.  
  81. THANKS
  82.    Thanks to:
  83.  
  84.    Yvon Rozijn for giving me specifications of 1.6/2.1 and 3.0 AWCR file
  85.    format (btw, as these ones may change don't try to resource this program:
  86.    it may be not nice to spread tools that can DAMAGE a newer AWCR file).
  87.  
  88.    Milco Veljanosky for his 100mb size cache (and his 800k AWCR file!) which
  89.    has given me a reason to write this tool and learn something new.
  90.  
  91.    Bill Parker for all his help!
  92.  
  93.    The italian music group called Pooh (see http://www.pooh.it) for their
  94.    GREAT live concert of 9/7/1997 !
  95.  
  96.  
  97. FUTURE
  98.    Any suggestion, bug report or critic is welcome!  Write me at:
  99.  
  100.    E-Mail:   favrin@tin.it
  101.    FidoNet:  2:333/726.8
  102.  
  103.    Please write me in italian or english, thank you.
  104.  
  105.    Visit my Home Page:
  106.    http://freepage.logicom.it/poing/
  107.  
  108.  
  109. CHILDWARE
  110.    This software is "CHILDWARE".  The author explicitly asks whoever uses
  111.    this program to make a donation toward a beneficial corporate body which
  112.    works in help of the children, in any form or way.
  113.  
  114.    If you don't know any, ask your local post office and inform yourself on
  115.    how to make a payment to The UNICEF.
  116.  
  117.    The amount of the offer is what you want, but please do it!
  118.